Nothing but Tetris

home *** CD-ROM | disk | FTP | other *** search

/ Nothing but Tetris / Nothing but Tetris.iso / amiga / speccy_tetris / spectrum.doc < prev next >

Wrap

Text File | 2000-01-01 | 53KB | 1,119 lines

Sinclair ZX Spectrum Emulator V2.0+ ---------------------------------- 7/7/94 This program emulates a Sinclair ZX Spectrum 48-kbyte z80-based computer on any Amiga computer. The files in this archive may be distributed anywhere provided they are unmodified and are not sold for profit. The file Spectrum.rom contains an image of the Spectrum's ROM and it is copyright to Amstrad. Cliff Lawson of Amstrad (CompuServe 75300,1517) has given special permission for emulator authors to use the Spectrum's ROM code. I have gone to a lot of trouble to make sure that the emulator runs on all amigas (from OS 1.2), so please don't compress the files with an old version of PowerPacker or Imploder, for example, which would render the emulator useless on a 68040 system. Ownership and copyright of all files except Spectrum.rom remains with the author: Peter McGavin, 86 Totara Crescent, Lower Hutt, New Zealand. e-mail: peterm@maths.grace.cri.nz Spectrum-00 is an executable for 68000-based Amigas only. Spectrum-10 is for 68010-based Amigas, but also works on higher processors. Spectrum-20 is optimised for 68020/30/40...-based Amigas with fast memory. Spectrum-00-special is for 68000-based Amigas. It is faster and dangerous. The Spectrum-00-special version takes some shortcuts to get some extra speed. Some games will run up to 2 times faster in Spectrum-00-special than in Spectrum-00, but because of the shortcuts, not all programs will work. In the special version: o Self-modifying z80 code does not work at all. This affects some games. It also means that you will only be able to run one program and then quit. If you try to load a second Spectrum program, without quitting Spectrum-00-special and re-running it first, it very probably won't work. o Code is optimised for faster animated graphics and scrolling, at the expense of speed when the display is static, so you will get faster animated games and slower ray-tracing :-) o The ROM is unprotected. Note that the standard Spectrum ROM corrupts itself. In particular, location 0 usually gets overwritten very quickly, so that RANDOMIZE USR 0 does not work any more. Do not try to develop or write Spectrum programs with Spectrum-00-special, because you will probably lose your work. It is provided only because it is significantly faster for running some animated Spectrum games. The emulator uses the dreaded move-sr instruction after almost every z80 instruction emulated. It ran 30-40% slower when I tried replacing the move-sr instruction with a call to GetCC()! This is quite exceptional --- with most programs you wouldn't notice the difference. Therefore I have supplied a 68010 version which uses move-ccr instead of move-sr. The Spectrum-20 version uses 68020 addressing modes which are not available on lower processors. I developed the code, entirely in assembler, in my spare time using z80 emulation code based (originally) on Ulf Nordquist's CP/M emulator (Fred Fish disk 165). I have fixed several bugs in the z80 emulation code, and made it more than twice as fast, but there are still some (very hard to find) bugs. Features: --------- The following Spectrum features are implemented: screen output in the same resolution and colours as a real Spectrum --- includes bright, reverse and flash attributes, and border colour (looks much better than the old TV!) keyboard implemented at the z80 "in" instruction level. Note that like a real Spectrum you have to hold the key down until it registers. Because the emulator is running slower, you might have to hold keys down longer. More often, you might have to hold your fingers off the keyboard for longer. Make sure the Spectrum window is active when you start to type. See Appendix 1 for key map. kempston joystick implemented at the Z80 "in" instruction level. This uses the rear Amiga gameport. Note that the joystick is active only when the Spectrum window is active. If another Amiga program is currently using the joystick, you will get a retry/no-joystick requester. sound implemented using 2 techniques. Calls to the "beeper" routine at $03b5 in the Spectrum rom are trapped and the sound is emulated at the exact same frequency and duration. Sound is also reproduced when a Spectrum program outputs to z80 port 254. In this case the pitch and duration may or may not sound correct, depending on the Spectrum program and the speed of the Amiga you are using. cassette tape loading, if you have a sound sampler capable of at least 20 kHz sampling rate attached to your parallel port. This is implemented by trapping calls to the "ld-bytes" routine at $056b in the Spectrum rom. Note that copy-protected games with custom loaders cannot always be loaded this way. It is possible to save to and load from amiga disk files. Operation: ---------- You can start the emulator from either the Workbench or SHELL (or CLI). If you use the SHELL (or CLI), Spectrum.rom must be in the current directory. You can specify the name of a snapshot file as a parameter and then the snapshot will be loaded automatically. From the workbench, Spectrum.rom should be in the same directory as the program. You can create project icons for your snapshots (e.g, with IconEdit), so you can have an icon for ManicMiner for example, but currently the emulator does not create its own icons. If the emulator can't find Spectrum.rom, then it will display a requester saying so, and it will not run. Under AmigaOS 2.x and up the emulator uses the ASL file requester. This is not available in earlier operating systems (e.g, 1.3), so in those circumstances the emulator tries to use the ARP file requester instead. If neither asl.library nor arp.library is available (in your LIBS: directory) then you cannot load or save disk files in the emulator. The emulator runs in its own custom screen and window. The emulator does not disable multitasking, and it does not interfere with other tasks (except when loading from a sound sampler). You can drag the screen down or click it to the back with the mouse, in the usual way. The emulator lowers its own priority to -5, otherwise it would significantly slow down other tasks. Raising the priority back to 0 does not significantly speed up the emulator on a standard system. Raising it higher prevents most other tasks from running at all. You can change the emulator's priority from the menus. To exit the emulator, do either of the following: o select "Quit..." from the Project menu, or o press the ESC key. Menus: ------ Project menu Reset... Resets the z80, unless you cancel the requester that pops up. This is like the Spectrum NEW command, but it works even when you are running an "unbreakable" or "crashed" program. Load snapshot... F1 Loads a disk file that has been created with "Save snapshot", restoring the state of the system to what it was when the snapshot was made. Any currently loaded Spectrum program is lost. You can use "Load snapshot..." even if the Spectrum has "crashed", or if you are running a Spectrum program which does not have a "quit" option. Save snapshot... F2 Saves the current state of the emulator to a disk file. The entire state of the system is saved, including all 48 kbytes of Spectrum ram and the state of the z80 processor. The format of a snapshot file is listed in Appendix 2. Help... HELP Displays the "Spectrum.help" file, which is a diagram of a real Spectrum keyboard. You need about 70 kb of CHIP ram free for this. Quit... ESC Quits the emulator. (You get a chance to change your mind.) Settings menu LOAD/MERGE/VERIFY... Selects what happens when the emulator executes a Spectrum BASIC LOAD, MERGE or VERIFY command. Note that this has nothing at all to do with "Load snapshot", which always loads from disk. What it does do, is to change the behaviour of the standard Spectrum BASIC tape loading commands, which are normally used to load, merge and verify BASIC programs, array data and binary code, from cassette tape. In fact, this selects what happens when any program (including any machine code program) calls the cassette tape loading routine in the Spectrum rom. You have a choice of: Disk files Select a disk file using a file requester. The data in the file is interpreted as if it is being read from cassette tape. The first byte in the file is the "header" byte, then the raw data, then the checksum byte. The Spectrum normally reads 2 blocks of data from cassette tape, a "header" file followed by the "data" file. These should be stored in 2 separate disk files. The emulator will request both files. I implemented it this way to allow support for "headerless" files which are used by many Spectrum machine code programs. Note that the Spectrum still thinks it is reading from cassette tape, so you might see messages like "Start tape now", even though it is reading from disk. If the file you select is not in the correct format, or if the checksum is wrong, the Spectrum will usually just request the same file again, without any messages, as if it read garbage noise from cassette tape. ProSound Read data from a ProSound sound sampler connected to the parallel port. Rombo Read data from a Rombo sound sampler connected to the parallel port (the sampler that comes with MegaMIX Master software). Please note that this option is untested. Other sampler Read data from any other kind of sound sampler connected to the parallel port. The sampler must be capable of at least 20 kHz sampling rate and it must be connected to the parallel port (not the game port). You should be able to feed standard Spectrum cassette tapes in. Some copy-protected programs have custom loaders that will not work in the emulator. It is possible to connect the Spectrum EAR output to the sound sampler to transfer data directly from your Spectrum. (Use a SAVE command at one end, and a LOAD at the other.) Important: Interrupts on the amiga are disabled while you are loading from a sound sampler. This will interfere with other tasks. For example, a file transfer running in the background will probably fail. Please make certain that no other tasks are writing to disk at the instant you start sampling! It seems as if the whole amiga has frozen while interrupts are disabled. To restore control, click the left mouse button. SAVE... Selects what happens when the emulator executes a Spectrum BASIC SAVE command. Note that this has nothing at all to do with "Save snapshot", which always saves to disk. What it does do, is to change the behaviour of the standard Spectrum BASIC SAVE commands, which are normally used to save BASIC programs, array data and binary code, to cassette tape. In fact, this selects what happens when any program (including any machine code program) calls the cassette tape saving routine in the Spectrum rom. You have a choice of: Disk files Select a disk file using a file requester. The data that would normally be written to cassette tape is written to the selected file instead. The first byte in the file is the "header" byte, then the raw data, then a checksum byte. The Spectrum normally writes 2 blocks of data to cassette tape, a "header" file followed by the "data" file. These should be stored in 2 separate disk files. The emulator will request both files. I implemented it this way to allow support for "headerless" files which are used by many Spectrum machine code programs. Note that the Spectrum still thinks it is writing to cassette tape, so you might see messages like "Start tape, then press any key". Audio Save to audio to be recorded on to cassette tape to be loaded back on a real Spectrum. WARNING: I have had a lot of trouble with this option (so I disabled it in earlier versions) and so far have not been able to load back anything I have ever saved, even though the noise sounds right and the code looks right. Maybe you will have better luck than me, but my guess is that there is something seriously wrong and that it will not work for anybody. Sorry there is no way to break into a save to audio in progress --- you have to wait until it has finished. The amiga continues to multitask, however. Audio Volume... Lets you choose the sound volume from one of: Off Quiet Normal (default) Loud Titlebar... Lets you turn the screen titlebar on and off. Task Priority Lets you choose the priority of the Spectrum task from one of: -10 Lowest priority -5 The default (and the recommended value) 0 Same as most programs 1 Same as workbench 2 5 Highest priority If you really want a priority that's not on the list, use one of the public domain system monitor programs like xoper or ARTM. But be careful --- you can lock up your system if you set it to 10 or more, because that is ahead of input devices or Intuition which the emulator relies on. In most circumstances changing the emulator's priority does not significantly affect the speed of the emulator. But because the emulator is a CPU hog (i.e, it does not normally Wait() because it is continuously busy emulating Z80 instructions), raising its priority will slow down or stop other tasks. More on Reading Cassette Tapes: ------------------------------- To load a cassette tape through your sound sampler, first select your sampler type in the Settings menu, then enter LOAD "" (that is, J followed by ALT/P twice, then RETURN). Now start the cassette tape playing into your sound sampler. If it is working, the screen border should flash colours, very much like your Spectrum, and the mouse pointer will be frozen. The MERGE and VERIFY commands should also work, as should things like LOAD "" CODE, etc. The border of the screen flashes different colours, exactly like a real Spectrum. The colours mean: flashing yellow and blue: the load is working flashing red and white: synchronising or not working not flashing: not working or tape not playing If it doesn't work, try adjusting the volume and tone controls on the tape recorder. If you have trouble, try adjusting the controls while sampling with software that came with your sampler. Ideally, the input should be a square wave which fills the graphic display. I found it necessary to have the volume control much lower than when using a real Spectrum, but it probably varies, depending on the sampler type. You should be able to save directly from your Spectrum to the Amiga with a direct connection --- i.e, no cassette tape or recorder at all. Use a SAVE command on the Spectrum and a corresponding LOAD command in the emulator. Loading works by intercepting calls to the LD-BYTES routine at location $056b in the Spectrum ROM. If a Spectrum program has its own loading routine, then it won't work. Some copy-protected games and fast-loaders are like that, and they will not work. On the other hand, some Spectrum programs call LD-BYTES to load headerless tape files. Those programs should work fine. If you have been using the parallel port recently (for printing or ParNet for example), you might get a requester asking you to please free up the parallel port. Try shutting down the program that has allocated it. The following sound samplers should be suitable, but I have not had the opportunity to test any except the first: o ProSound o Rombo (the one that comes with MegaMIX Master) o Perfect Sound (except that recent Perfect Sound samplers are different from early versions and recent ones might not work) o Datel DSS o Future Sound Documentation on how various samplers work seems to be hard to obtain. They all seem to be slightly different, especially the way stereo/mono modes are switched and different channels are selected. For the technically minded, here are the cia register settings currently used by the loader: ProSound Rombo Other setup ciab-ddra 4 7 6 setup ciab-pra 4,0 or none * 6 4 inter-sample ciab-pra 4,0,4,0 none none ciaa-prb input bias $80 $80 $80 * If bit 0 of ciab-pra is 0 then output 4 followed by 0 else none. Note that the tape-loading routine disables interrupts for the whole time it takes to load a tape. That greatly exceeds Commodore's recommended limit of 250 microseconds. While interrupts are disabled, the mouse pointer freezes, the keyboard is locked out, all other tasks stop, and any data arriving at the serial port is lost. Please make sure your disks are not busy when you start to load a tape. Especially make certain that no other program is writing to your hard disk! If I knew another way to make it work, I'd do it that way. As far as I am aware, all sound sampling software on the Amiga disables interrupts for excessive periods. The Spectrum loader has to interpret the incoming data in real time, which is quite a lot more than just saving it to a buffer in memory. To break out of the load routine without actually loading anything, press the left mouse button. The Spectrum BREAK key (SHIFT/SPACE) won't work in this situation. The load routine is based on code kindly provided by Kristian Nielson. It has been tested on both standard and accelerated amigas. General Notes: -------------- o The emulator runs about 2 to 8 times slower than a real Spectrum, on a standard 68000-based A500. If you are the lucky owner of an Amiga 3000, the emulator runs faster than a real Spectrum, but make certain it's running out of FAST ram. If you run it out of CHIP ram, then it's more than twice as slow. I'm afraid the 68000 doesn't have a built-in z80 emulation mode, and a 3.5 MHz z80 is much harder to emulate than a 6502 as used in the Commodore 64 and BBC microcomputers. The Spectrum NEW command takes 9.7 seconds on an A500, compared with about 2.0 seconds on a real Spectrum, 1.8 seconds on an A3000 (in FAST static-column ram), and 1.6 seconds on a 33MHz Mega-Midget-Racer with 32-bit ram. One person reported to me that it runs about 3 times faster again on a 68040. Several people have told me that some games run too fast on an A1200! o This version of Spectrum uses the blitter to refresh the screen in parallel with the emulator. That is, it uses multi-processing. Thus, the overhead of a z80 instruction writing to the Spectrum's display file is minimised. Before you A3000 owners complain that the 68030 is faster than the blitter for blitting, remember that while the blitter is refreshing the screen, the 68030 is busy emulating the z80. The program uses QBlit() for concurrency, not OwnBlitter() which would block the z80 emulator. o I've just about run out of ideas on how to significantly speed up the code from what it is now. One thought is to code some common ROM routines in pure 68000. Obvious candidates are the text output, scrolling, and maskable interrupt routines. Of course this would only speed up programs that call the ROM, which excludes most games. Also, It would probably be illegal. The major speed bottleneck used to be the z80 instruction decode. I've pretty well eliminated that by going to threaded code. The display routines are about as fast as I can get them. Taking over the machine and doing everything at the hardware level would probably give only a slight speed improvement, and the program would become much less friendly and less portable. o The emulator calls CopyMem() and CopyMemQuick() in several places. You may or may not achieve a speedup by installing the Public Domain CopyMemQuicker patch by Arthur Hagen, depending on your configuration. (I found CopyMemQuicker available for ftp on amiga.physik.unizh.ch and ftp.etsu.edu.) o In version 1.7, the following Spectrum features are NOT implemented yet: bank roms (e.g, Interface 1); printing to a printer o The following z80 features are NOT properly implemented: the z80 h processor flag; the z80 daa instruction (decimal adjust a) --- daa works properly only immediately after add, sub, adc or sbc. A few games use daa in the scoring routine and might fail because of this. undocumented condition code flags do not necessarily behave the same as on a real Z80. Some programs probably fail because of this. the timer interrupt occurs after every 1500 branch, jump, call and return z80 machine instructions, instead of every 20 ms. On accelerated amigas, interrupts will not occur any faster than every 20 ms. updating of the flash attribute occurs every 24000 branch, jump, call and return z80 instructions, instead of every 320 ms. On accelerated amigas, the flash speed will never be faster than every 320 ms. interrupts and screen updates can occur only immediately after branch, jump, call, return and halt z80 machine instructions. because the emulator is not real-time, the real interval between timer interrupts and flash attribute updates depends on the nature of the Spectrum program being run. there might still be rare problems executing certain long, self-modifying z80 instructions located at exactly 32763..32766 in z80 memory, because of the 68000 addressing modes used to load instruction operands; there is at least one other bug I haven't been able to track down yet. o The emulator allocates and uses two sound channels. If there are not enough free channels, you get the option of running the emulator with no sound. If you have enough memory you can test this by running 3 copies of Spectrum at once! o Because it's running slower, maybe now you can get past that "impossible" level in your favourite game. o Now you can print Spectrum graphics by transferring to your Amiga. o If you're cross-developing Spectrum software, now you can see which parts need speeding up. o I've tested it with several Sinclair Basic programs and all ran perfectly. o I've tried lots machine-code programs and most work ok. The following programs seem to work ok in the emulator: Zeus Assembler and Monitor Scrabble Jetset Willy Atic Atac Jetpac Tron The Train Game Backgammon PSSST Horace and the Spiders Sam Spade Draughts Sam Stoat 3D Deathchase Technician Ted Kosmic Kanga Monty Mole Talk Chess Horace Goes Skiing Hungry Horace Star Raid Cyclone Wheelie Full Throttle Mugsy Dynamite Dan Dynamite Dan II Heathrow IS Chess 48 Matchpoint Max Headroom no joystick Spy vs Spy Kong The Alchemist Daley Decathlon Automania Penetrator Gyron Alien8 Cyberun KnightLore Batman Tomahawk Fighter Pilot Athena Basil the Detective Pacland Orbix Meteor Manic Miner Madmix Kokotoni Wilf Ikari Warriers Gauntlet Dustin Ant Attack St Bernard resets the Spectrum at the end of the first level. SabreWulf runs, except sometimes the rhino runs backwards (very amusing). (If you know why either of these programs don't work, please tell me.) Note: The Amiga doesn't crash. If a Spectrum program crashes, you can either: Quit the emulator and continue working on the Amiga, or: Press F1 and load another snapshot. Note: Some of the above have not been tested since Spectrum v0.7 or v0.8. Another note: Some of the above programs won't load from tape, but they will run if you can create a snapshot file somehow (e.g, Mirage Microdriver and serial port). One user reported to me that out of 350 games he tried on his A1200, all except about 10 or 15 worked properly. (He was not loading from tape.) Other people have sent me long lists of hundreds of games that work okay. o One problem I have had with snapshotting games by transferring a snapshot file from the real Spectrum to the amiga, is as follows: If there is non-standard hardware in your real Spectrum (like a non-standard joystick or disk drive), and the program knows about the special hardware, then the program might have already done a hardware test (before you made the snapshot) that makes it believe the special hardware exists permanently. Then, when run under the emulator, the program tries to access the non-existent hardware and behaves erratically. What is wrong is that the program was started in one environment (the real Spectrum with add-ons) and is now running in another (the plain Spectrum emulator). For example, if your program behaves as if the joystick button is continuously pressed (when run in the emulator), maybe it is because you made the original snapshot from a Spectrum which has non-standard joystick hardware. See if you can disconnect the joystick interface and reload the original program from tape before you make a snapshot. o I am not supplying the source of the emulator yet. o Please report bugs to peterm@maths.grace.cri.nz. I'd much prefer bug reports like "the `or' instruction doesn't zero the carry flag" to "Dan Dare doesn't work". Appendix 1: The keyboard: The Spectrum has a weird way of mapping functions to keys that doesn't translate nicely to the Amiga. To get a "[" on a real Spectrum, for example, you press CAPS-SHIFT and SYMBOL-SHIFT together followed by SYMBOL-SHIFT and F. In the emulator, you do the same thing except CAPS-SHIFT is either of the SHIFT keys and SYMBOL-SHIFT is either of the ALT keys. Pressing "[" on the Amiga keyboard won't work. The following table lists the Amiga key(s) corresponding to each Spectrum key: Amiga key Spectrum key 0..9 0..9 keypad 0..9 0..9 A..Z A..Z SPACE SPACE RETURN or ENTER ENTER either SHIFT key CAPS-SHIFT either ALT key SYMBOL-SHIFT The following special Amiga keys correspond to Spectrum key combinations. Amiga key Spectrum key combination . SYMBOL-SHIFT/M , SYMBOL-SHIFT/N ; SYMBOL-SHIFT/O - SYMBOL-SHIFT/J = SYMBOL-SHIFT/L keypad ( SYMBOL-SHIFT/8 keypad ) SYMBOL-SHIFT/9 keypad / SYMBOL-SHIFT/V keypad * SYMBOL-SHIFT/B keypad - SYMBOL-SHIFT/J keypad + SYMBOL-SHIFT/K keypad ENTER ENTER keypad . SYMBOL-SHIFT/M left arrow SHIFT/5 down arrow SHIFT/6 up arrow SHIFT/7 right arrow SHIFT/8 ESC quits the emulator (unless you cancel the requester that comes up). HELP displays the Spectrum.help file, which is a diagram of the real Spectrum keyboard. (You need about 70 kb of CHIP ram free for this.) F1 brings up the load snapshot requester. F2 brings up the save snapshot requester. F3 changes the sampler type for cassette tape loading. All the other Amiga keys do nothing. Note that the Amiga's hardware and software impose some restrictions on the number of keys that are recognised when several keys are held down at once. This varies between models of amigas, but don't expect 3 or 4 keys down at once to behave exactly the same as a Spectrum. Appendix 2: Snapshot file format: This format is based on the format used by the Mirage Microdriver "Dump" command. Snapshot files are always 49179 bytes long. Note that in the table, the byte offset starts from 0, not 1. Byte offset into file Value 0 i register 1 l' register 2 h' register 3 e' register 4 d' register 5 c' register 6 b' register 7 f' register 8 a' register 9 l register 10 h register 11 e register 12 d register 13 c register 14 b register 15 iy low register 16 iy high register 17 ix low register 18 ix high register 19 bit 2 is set if interrupts are enabled 20 r register 21 flags register 22 a register 23 sp low register 24 sp high register 25 interrupt mode (0, 1 or 2) 26 border colour in low 3 bits 27..49178 48 kbytes ram dump The JPP Spectrum emulator for 80386-based PC's by Arnt Gulbrandsen uses exactly the same snapshot format. Appendix 3: Other Spectrum Emulators: When I started this project I did not know of any other Spectrum emulators. Now I have heard of at least 12, including this one, in various stages of development. 1: This one. 2: The public domain K.G.B. emulator advertised in "Amiga Format". I have seen only version 1.2 which does not multitask and does not work properly on my A3000. 3: An Italian emulator was released (possibly commercially) about 4 years ago by A.Schifano and Gervasi. The version I saw was very bug free and worked on accelerated amigas, but it did not multitask and was slightly slower than mine. A believe that an early (buggy) demo version was released on the coverdisk of an Italian magazine several years ago too. 4: An emulator is under development in Sweden. 5: Another emulator, intended to be commercial, was written in Holland, but it was never released as far as I know. From what I have heard about it, it is much faster than mine. 6: The Whitby Software Spectrum Simulator is a Spectrum ROM rewrite for the C64. It runs just fine under TheA64Package and is surprisingly fast. Because it is a ROM rewrite and not a z80 emulator, you cannot run z80 machine code programs (i.e, most games). 7: VGASPEC is a Spectrum emulator for the IBM-PC and clones (not for the amiga). A VGA graphics adaptor is required. I think it was developed in Spain or Portugal (I don't recognise the language that all the messages are written in). 8: JPP is another Spectrum emulator for the IBM-PC and clones, developed recently by Arnt Gulbrandsen. An 80386 and VGA are required. It is faster than VGASPEC. The name JPP is derived from the keys you press to get LOAD "". 9: There is another very good Spectrum emulator for the IBM-PC. It is called Z80, and written by G.A.Lunter, and it includes lots of advanced features. 10: There is a Spectrum emulator for the Atari ST available from various ftp sites. Try terminator.cc.umich.edu, perhaps directory /atari/emulators. 11: I heard from one person working on a Spectrum emulator for the BBC RISC computer (status unknown). 12: I have heard rumours of other emulators in various stages of development in Australia and Germany for platforms including the Amiga, the IBM-PC and Unix/X-Windows. There is a good collection of Spectrum emulators available by ftp from wuarchive.wustl.edu and its mirrors. Programs to convert between various snapshot formats are also available there, in source form. (Look in the PC Spectrum emulator archives for these.) Other ftp sites to try are ftp.nvg.unit.no (run by Arnt Gulbrandsen) and ftp.sun.ac.za (in South Africa). There is also a mailing list for Sinclair-related gossip. E-mail Mauricio Tavares at mauricio@gauss.aero.ufl.edu for details. Appendix 4: Update Notes: v0.0 22 Oct 1990 First release. v0.1 15 Nov 1990 Sped up display code slightly. Also sped up main instruction decode slightly. Display flash attribute as reverse. v0.2 30 Dec 1990 Now use double buffered display and implemented flash attribute properly. Added error requesters. Used pc-relative jump tables in z80 emulator --- slightly faster, and much, much smaller. v0.3 20 Jan 1991 Changed display routines to update screen periodically instead of after every z80 instruction that pokes the Spectrum's display file. Used the blitter for this, running in parallel with the z80 emulator. (Only character rows that have changed since the last screen update are redrawn.) Reverted to single buffer display and used blitter to implement flash. (It's smaller and faster this way.) Fixed bug where couldn't use path string in arp file requester. v0.4 Changed the z80 emulator to use threaded code. Now all that is executed between each pair of z80 instructions is "move.w (a3)+,d6; jmp table(pc,d6.w)" instead of about ten 68000 instructions to decode the next z80 opcode byte. Overheads introduced are a new 128 kbyte table giving the routine offset for every byte in z80 ram, and the necessity to write a zero word into this table every time the emulator writes to z80 ram. The overall speed increase is about 20%. Expanded some subroutines to macros and expanded $dd and $fd prefix instructions to independent code for a slight speed increase. A side-effect is that the executable increased in size from 27k to over 40k. Introduced some bugs during the systematic changes that are proving hard to track down. v0.5 7 Apr 1991 Fixed bug in "sra a" instruction. Fixed bugs in rotate and shift (ix+d) and (iy+d) instructions. Fixed bugs where used "offset(a4,rr.w)" to address z80 memory space where offset is -2, -1, 1 or 2. (Can't use that mode because of the unlikely event of rr.w being near $8000.) Implemented mode 2 interrupts. Low byte of interrupt vector (normally provided by an external peripheral device) is assumed to be 0. Increased the interrupt interval from 2500 instructions to every 5000 instructions, because otherwise some programs with their own (mode 2) interrupt routines overflowed the stack. v0.6 23 Apr 1991 Fixed bugs in the following z80 instructions: ld ixh,b ld ixh,d rl (ix+dd) rr (ix+dd) sla (ix+dd) cpdr and iy equivalents of the above instructions. Implemented ini, outi, ind, outd, inir, otir, indr, otdr. (Out instructions do nothing). Now preserve (otherwise) unused flag bits in push af, pop af and ex af,af' (instead of setting them all to 0). Changed layout of vector table for threaded code (origin now in middle). Fixed bug in vector table wraparound code (when pc incremented from 32767 to 32768). Sped up ram writes by optimising macro for writing a byte to ram. Added processor type check. Now you get a requester when you try to run the wrong version for your processor type, instead of "Software Error, Task Held". Implemented sound by opening audio.device and trapping calls to the "beeper" subroutine at $03b5 in Spectrum ROM. v0.7 Optimised blits to update flash attributes by keeping track of which parts of the display are flashing and updating only those parts. That saves a lot of blits. No blits are needed at all when there are no flashing characters displayed. It used to redraw the entire display for every blink. v0.8 13 May 1991 Further optimised the display routines by adding a 6144-byte lookup table. v0.9 22 Jul 1991 Lower task priority to -5 at startup. This is friendlier to other tasks because Spectrum is highly CPU intensive. If Spectrum is running at a higher priority than another task, then that other task is completely blocked. Sped up the emulator by 5% by checking for interrupts only after branch, jump, call and return instructions, instead of after all instructions. Open gameport.device and emulate Kempston joystick (at Z80 "in" instruction level) using the rear Amiga gameport. v0.9b 1 Sep 1991 Implemented all the undocumented z80 sls instructions. Fixed bug in ld (nn),sp instruction. (It didn't work at all!) Implemented the z80 n flag --- all instructions now set/reset the n flag. Fixed bugs in inc/dec (hl), inc/dec (ix+dd) & inc/dec (iy+dd) (never set v). The daa instruction now works correctly after add and sub (not just adc & sbc). Incorporated Kristian Nielson's tape load routine. Allocate/free misc.resource. Added "File already exists! Overwrite?" requester (in save snapshot). Fixed keypad 0 key. Rationalised keyboard. Arrow keys are now equivalent to SHIFT+5/6/7/8 instead of 5/6/7/8 (without the SHIFT). ESC key quits. The halt instruction now calls WaitTOF(). (Was too fast.) The Spectrum Basic PAUSE function now works correctly. Added a separate timer task to prevent interrupts occurring too quickly. The "flash" rate and keyboard interrupt rates are now more constant. The HELP key now displays Spectrum.help IFF/ILBM file from current directory. Reorganised register usage in z80 emulator to try to speed it up (lots of work but not much success). v1.0 9 Nov 1991 Implemented menus. Added noise correction code to cassette tape loader. Added support for 2 kinds of sound samplers. Screen to front after error requester in IFF loader. Use an interrupt server instead of extra task for timer. Further optimised blitter routines. Put z80 parity byte in a register (slight speedup). Implemented ld-bytes and sa-bytes to/from disk. v1.1 Dec 1991 Created 68020 version (uses 68020/30/40-only addressing modes for extra speed) Moved z80 address space to FAST RAM with a copy of 16384..22527 in CHIP RAM (instead of having the whole Z80 address space in CHIP RAM). Added more undocumented z80 instructions. Sped up display routines by changing update algorithm. Animated graphics and scrolling are now faster by a factor of 2 or 3. v1.2 7 Jan 1992 Rewrote joystick handling routines to avoid continuous polling. v1.3 Feb 1992 Implemented a much faster algorithm for handling z80 prefix instructions that was suggested to me by Richard Carlsson. Preserve high bit of R register between LD R,A and LD A,R, and also in snapshot files. Tomahawk works now. GetCC() is now documented to preserve d0/d1/a0/a1. Fixed movesr macro. Mode 2 interrupts assume $ff is on the external bus, not $00. This change fixed quite a few games. Fixed glaring bug in "set 4,l" instruction. Sabre Wulf, Fighter Pilot, Basil the Detective, Athena and lots of other programs work now. Changed implementation of daa instruction to speed up add/adc/sub/sbc instrs. Use blitter to do comparisons as well as copies in display updater. Sped up CPU computation of blitter attribute masks in display updater. Display updater now translates black to bright black on the fly. This leaves a colour register free for the border colour (one day). Fixed bug in display updater that caused flashing to fail sometimes. v1.4 17 Mar 1992 Changed ld-bytes ROM patch entry point from $0556 to $056b to be compatible with more programs. v1.4a 22 Mar 1992 Sped up LDIR by calling CopyMem(). This nearly doubled the speed of some programs (e.g, ManicMiner and JetsetWilly). Increased the interrupt rate and screen refresh rate when executing lots of large LDIRs. v1.5 27 Dec 1992 (This version later abandoned) Major revamp of z80 emulator, as suggested by several correspondents (3 days' work). Implemented conventional decoding scheme for z80 instructions, and did away with threaded code tables and the overhead of updating them on every write. 68000 and 68010 versions now use 2-instruction decode (self-modifying) as follows: move.b (a3)+,1$+2-base(a5) ; get opcode and modify next instr 1$: jmp $ff00(a5) ; jump directly to next instruction 68020/30/40 version uses a slightly longer macro to avoid self-modifying code. Instruction routines are all exactly 256 bytes in size and the total size of all 256 routines is 64 kbytes. Added about 5 more such 64 kb blocks of code for prefixed instructions. Managed to interleave all the 64 kb code blocks so that they effectively reduced to a single 64 kb code block (even sharing the same base address register but each table having a different byte-offset). About 25 instruction routines didn't fit in their allocated space and required long jumps to routines elsewhere. Several features broke, including ROM write-protection, invisible ROM-hooks for load/save/beep, (in fact I did not re-implement ROM hooks, so loading, saving and sound did not work at all), daa mechanism, fast prefix mechanism, potential to treat common sequences of instructions as a single instruction with no overhead, etc. Speed was almost exactly the same as v1.4a (which still had the broken features intact), and there seemed to be no significant advantages. v1.6 25 Jan 1993 Gave up on conventional decoding and reverted to v1.4a sources. Implemented border colour (at last!) Made window borderless and changed colours. The old "filler" byte in the snapshot file format now holds the border colour. Added "Reset" menu item. Changed sa-bytes ROM patch entry point from $04c2 to $04c6 to be compatible with more programs. The ld-bytes and sa-bytes routines were not always setting the de, ix and flag registers on return, causing some tape-copying programs to fail. Corrected the problem. File-names longer than 10 characters passed to the SAVE command could crash the amiga. Corrected the problem. Added support for Rombo sound sampler (the one that comes with MegaMIX Master). I do not own a Rombo sound sampler and I have been unable to test this option. (I used information provided by a correspondent in Portugal, who also informed me that v1.4a did not work with his Rombo sampler.) Implemented sound at the z80 port 254, bit 4, level. Changed keyboard handling code to precalculate the most common z80 port address values whenever a key is pressed or released, instead of doing a full calculation every time an "in" instruction is executed. v1.7 7 Jun 1993 Sped up OUT instructions. (Sound is noticeably higher pitched.) Fixed bug where key-up event was lost after SAVE-ing to disk. Applied dozens of small code optimisations suggested by Mark Knibbs, mainly in the Z80 emulator and in the display routines. Input from IO port 255 (or any other port than the standard ones) now sometimes returns 0 or a video attribute from the current display, to better emulate a real Spectrum. It used to always return 255. Fixed bug which caused emulator task to go into an unbreakable loop when certain multi-byte instructions crossed the 32767/32768 address boundary. Use ASL file-requester if available (requires OS 2.x and up for this). Moved requesters to custom screen. Added menu options to switch the titlebar on and off, set the task priority and control the sound volume. Enabled "Save to Audio", even though it doesn't seem to work properly. Window is now a title-less backdrop window that is the width of the screen. The close-box feature has gone. Use menus or ESC to quit instead. Load snapshot from CLI command-line or project icon. Distribute Spectrum.rom with emulator.